home *** CD-ROM | disk | FTP | other *** search
/ HyperLib 1997 Winter - Disc 1 / HYPERLIB-1997-Winter-CD1.ISO.7z / HYPERLIB-1997-Winter-CD1.ISO / オンラインウェア / UTIL / Edit II 2.2.1.sit / Edit II 2.2.1 / Edit II Doc next >
Text File  |  1993-03-11  |  20KB  |  598 lines

  1.  
  2.  
  3. Edit II Version 2.2.1 (March 11, 1995)    Page 1
  4.  
  5.  
  6. Edit II Version 2.2.1
  7. ゥ 1990-95 Kenneth Seah
  8. Portions ゥ by Symantec
  9.  
  10. An enhanced text editor for the Macintosh
  11.  
  12. 0.    Prologue
  13.  
  14. This application is copyrighted by Kenneth Seah and is distributed as
  15. shareware. You are welcome to try out Edit II for a week or two and if you
  16. decide that it's something you want to use, send a check drawn on a US Bank
  17. or a draft for US$15 (US$18 if you want a disk with the latest release)
  18. made out to me at the address below, enclosing the little questionnaire on
  19. page 11. Iユll answer your problems and consider bug fixes via electronic
  20. mail (Internet or America OnLine) if you are registered. As a registered
  21. user, you may obtain the latest release at all times from one of the above
  22. services (you have to bear the online connect and download charges but
  23. otherwise all upgrades are free). If you do not have access to any of the
  24. services, send US$3 to the address below and Iユll mail you a disk with the
  25. latest release.
  26.  
  27. Otherwise, give a copy of it to a friend, enclosing this file too and trash
  28. your copy (since it takes up valuable space on your disk).
  29.  
  30. I'll consider that you have been registered once you have sent in your
  31. shareware fee. Upgrades will be posted to America OnLine and Internet. I
  32. can work out a ヤsite licenceユ fee if you need several copies installed at
  33. your place.
  34.  
  35. For commercial distribution and correspondence, please contact:
  36.  
  37. Kenneth Seah
  38. P O Box 8565
  39. Austin, TX 78713-8565
  40.  
  41. America OnLine: KSeah (kseah@aol.com)
  42. Internet: kseah@procyon.austin.tx.us
  43.  
  44. 1.    Introduction
  45.  
  46. Edit II is intended as a replacement for the Consulair Edit text editor but
  47. which allows the use of the cursor keys on the Mac keyboard for navigation.
  48. It is not, however, a product of Consulair and is not a revision of the
  49. Edit application.
  50.  
  51. The num lock LED on the extended keyboard is used to indicate whether the
  52. cursor pad or the numeric pad mode is on. The home, end, page up, page down
  53. keys will also work, as will the delete right (del) key. One level of undo
  54. is supported. You can launch Edit II by double clicking old Edit files
  55. (since Edit II uses the same creator signature as Edit, that is, EDIT).
  56. This means that you might want to rebuild the desktop after installing Edit
  57. II.
  58.  
  59. Edit II requires System Software 4.1 or later and above and is
  60. Multifinder-friendly. It is also 32-bit clean and runs fine under System 7.
  61. Edit II now handles System 7 stationery documents.
  62.  
  63. This program is compiled using Symantec C 7.0.3 and uses the Cappsユ Editor
  64. Toolkit.
  65.  
  66. 2.    Menus
  67.  
  68. Edit II works just like Consulairユs Edit. Each of the menus and their
  69. respective commands are described in the subsequent paragraphs.
  70.  
  71. File menu
  72.  
  73. New
  74. Creates a new window named ヤUntitled-Nユ for editing, where N is a number
  75. starting at 1.
  76.  
  77. Open...
  78. Displays the standard file open dialog box to allow the selection of a file
  79. to edit. The dialog box will display all files of type ヤTEXTユ, ヤRRRSユ (Red
  80. Ryder script files) and ヤttroユ (TeachText read-only text files). Stationery
  81. documents under System 7 will be opened as ヤUntitled-Nユ windows. Holding
  82. down the option key while selecting open will show all files.
  83.  
  84. Close
  85. Closes the frontmost editing window. If the file has been changed in any
  86. way, the standard file save dialog box will be displayed.
  87.  
  88. Save
  89. Saves the frontmost window to its file on disk. If the file has not been
  90. previously saved, perform a ヤSave As...ユ operation.
  91.  
  92. Save As...
  93. Saves the frontmost window to a differently named file by presenting the
  94. standard file save dialog box. The dialog box also allows you to select
  95. which line termination character you want to use (Mac uses control-M, DOS
  96. uses control-M control-J while UNIX uses control-J.
  97.  
  98. Revert
  99. Reverts the frontmost window to the most recently saved version of the
  100. file. A prompt message is displayed to confirm the action.
  101.  
  102. Page Setup...
  103. Displays the standard printer Page Setup dialog box.
  104.  
  105. Print
  106. Displays the standard printer Print dialog box to initiate printing of the
  107. frontmost window.
  108.  
  109. Transfer
  110. Displays the standard file selection dialog box to choose an application
  111. program to run.
  112.  
  113. Quit    
  114.     Quits Edit II after prompting for saving of any changed windows.
  115.  
  116.  
  117. Edit menu
  118.  
  119. Undo
  120. Reverts from the previous editing operation.
  121.  
  122. Cut
  123. Removes the currently selected text and copies it into the clipboard.
  124.  
  125. Copy
  126. Copies the currently selected text into the clipboard without deleting it.
  127.  
  128. Paste
  129. Pastes the clipboard text at the insertion point. If a range has been
  130. selected, then the pasted text will replace the selection.
  131.  
  132. Clear
  133. Deletes the currently selected text without copying it to the clipboard.
  134.  
  135. Select All
  136. Selects all the text in the frontmost window.
  137.  
  138. Search menu
  139.  
  140. Find...
  141. Displays the ヤfind and replaceユ dialog box for entry of search (Find) and
  142. replacement (Replace with) strings. GREP-style searching is available (see
  143. later on how to define GREP search and replacement strings). The ヤfind and
  144. replaceユ dialog box has several options:
  145.  
  146. ヤMatch Wordsユ will only flag a match if there is an exact word for word
  147. match with the search string.
  148.  
  149. ヤWrap Aroundユ will flag matches even when the words wrap over at the end of
  150. a line.
  151.  
  152. ヤIgnore Caseユ will flag matches even when the cases (capitals and small
  153. letters) do not match but the letters do.
  154.  
  155. There is an option to do multi-file searches of all TEXT-type files inside
  156. a folder. The multi-file search is activated by clicking on the Multi-File
  157. Search checkbox which brings up the standard file selection dialog box.
  158. Selecting a TEXT-type file will initiate multi-file searches of the search
  159. string for all TEXT-type files within the folder. Note that multi-file
  160. searching does not descend into subfolders (i.e. one folder level only).
  161.  
  162. Cutting and pasting of text selections is allowed into the search and
  163. replacement strings in the ヤfind and replaceユ dialog box. This is achieved
  164. by using the command-C and command-V combinations. If you want to enter the
  165. tab or return characters in the Find dialog box, key in command-tab and
  166. command-return respectively.
  167.  
  168. Search and replacement strings are retained between searches. The ヤDonユt
  169. Findユ button will retain the search and replacement string entries but will
  170. not initiate any searches. The ヤCancelユ button on the other hand, will
  171. ignore any entries made for these strings.
  172.  
  173. Enter Selection
  174. Puts the currently selected text into the search string.
  175.  
  176. Replace
  177. Replaces the currently selected text with the replacement string.
  178.  
  179. Replace and Find Again
  180. Replaces the currently selected text with the replacement string and
  181. searches for the next occurrence of the search string.
  182.  
  183. Replace All...
  184. Replaces all occurrences of the search string with the replacement string.
  185. Prompts for confirmed replacement if required.
  186.  
  187. Find in Next File
  188. Only operable under multi-file searches ミ will look for occurrence of the
  189. search string in the next file in the specified folder.
  190.  
  191. Go to Top
  192. Go to Bottom
  193. Move the insertion point to the beginning or end of the file, respectively.
  194.  
  195. Go to Line#...
  196. Displays a dialog and moves to the specified line.
  197.  
  198. Goodies menu
  199.  
  200. Shift Left
  201. Shift Right
  202. Moves the selected text one space to the left or right.
  203.  
  204. Balance
  205. Extends current selection to encompass the next level of enclosing braces
  206. {}, brackets [] or parentheses (). A beep means that the text could not be
  207. balanced. [Great for C and Lisp people!]
  208.  
  209. Add LFs
  210. Adds linefeed characters to the end of every line.
  211.  
  212. Strip LFs
  213. Removes linefeed characters from the text.
  214.  
  215. Wrap to Column...
  216. Wraps the text to a user-specified column, default is the window wrap
  217. column.
  218.  
  219. Wrap to Window
  220. Wraps the text to the window width.
  221.  
  222. Unwrap
  223. Almost the reverse of the above wraps. What Unwrap does is to replace all
  224. single occurrences of the ヤreturnユ character by a space and leave multiple
  225. runs of returns untouched. Thus a ヤparagraphユ is recognized as ending in
  226. two or more returns.
  227.  
  228. Tabs to Spaces
  229. Spaces to Tabs
  230. Converts tabs to spaces based on the current メnumber of spaces to tabsモ
  231. settings, and vice versa.
  232.  
  233. Remove Invisibles
  234. Removes all the invisible (non-printing) characters with the exceptions of
  235. tab, return and linefeed.
  236.  
  237. Options menu
  238.  
  239. Font
  240. Size
  241. Creator
  242. Select the font, size and  creator for the file being edited. The size
  243. submenu has ヤLargerユ, ヤSmallerユ and ヤOther...ユ commands to allow for
  244. selection of non-standard sizes. The creators supported by Edit II are:
  245.  
  246. EDIT    Consulair Edit (and Edit II)
  247. MPS    Apple MPW
  248. KAHL    Think C/Think Project Manager
  249. PJMM    Think Pascal
  250. ALFA    Alpha
  251. MACA    MacWrite
  252. MSWD    Microsoft Word
  253. nX^n    WriteNow
  254. ttxt    TeachText
  255. PEDT    DA Edit or PEdit
  256. WNGZ    WingZ
  257. WPC2    WordPerfect
  258. L123    Lotus 1-2-3
  259. CIM    CompuServe Information Manager
  260. MRIP    TScript
  261. Rich    BBEdit
  262. AOqc    America Online
  263.  
  264. Default font is Monaco, default size is 9 and default creator is EDIT.
  265.  
  266. Set Tabs...
  267. Sets the number of spaces to one tab stop for the topmost window(default is
  268. set in the preferences dialog. Initially 4 spaces to the tab).
  269. Set Wrap...
  270. Sets the column at which the text will be wrapped at (actually the first
  271. space typed after this column causes the wrap, and not the same as doing a
  272. ヤWrap to Column...ユ). Default is specified in the ヤWrap atユ item in the
  273. preferences dialog (initially 80).
  274.  
  275. Autowrap
  276. Toggles autowrap mode on or off. The icon at the bottom left of the window
  277. indicates the mode. Clicking on the icon will change states.
  278.  
  279.  
  280.  
  281. Preferences...
  282. Displays a dialog box to allow changing of default preferences. Font, size,
  283. creator and spaces per tab can be set. The radio buttons and check boxes
  284. are covered below.
  285.  
  286. Strip LF
  287. Selecting the Strip LF option removes the linefeeds when the files are read
  288. in. 
  289. SmartStrip
  290. SmartStrip is an intelligent linefeed remover in which linefeeds are
  291. removed when the file is read and replaced (after each CR or replacing each
  292. CR - depending on the input format) when the file is written back. The
  293. default option is SmartStrip.
  294. Donユt Strip
  295. Donユt remove any linefeeds on file open.
  296.  
  297. Horizontal
  298. Vertical
  299. Sets the default new window horizontal and vertical size. The ヤMax Screen
  300. Sizeユ button puts the size of the current screen in these items. Checking
  301. the ヤUse monitor sizeユ box disregards the horizontal and vertical size
  302. settings and makes all new windows open to full monitor screen size (which
  303. is the default case).
  304.  
  305. Auto Indent
  306. Toggles automatic indentation of text (useful for programmers). Default is
  307. autoindent on.
  308. New Untitled
  309. If selected, displays an Untitled window when starting Edit II (next time
  310. of course). Default is on.
  311. Print Headers
  312. If selected will print informative header information at the top of every
  313. page. Default is to print these headers.
  314. Cursor Jump
  315. Uses the ヤ-ユ key on the keypad to invoke the cursor jump feature (see
  316. later). Default is on.
  317. Auto Wrap on Open
  318. Automatically wraps the text file to the default window wrap column (see
  319. below) when opened. Very useful for reading TeachText files. Default is
  320. off.
  321. Autowrap
  322. Automatically wraps text at the first space typed after the window wrap
  323. column. The ヤWrap atユ box is the default value of the wrap column for new
  324. windows (initial value is 80). Autowrap defaults to off.
  325.  
  326. Save Preferences Button
  327. Saves the option settings (all the items in the preferences box) into the
  328. EditPrefs file which is stored in the Preferences folder of the System
  329. Folder.
  330.  
  331. Windows menu
  332.  
  333. Layer
  334. Layers all the windows neatly on the screen. The previous frontmost window
  335. is brought to the front. 
  336.  
  337. Tile
  338. Tiles all the windows neatly on the screen. The previous frontmost window
  339. is selected. This option is active for 9 or less windows. 
  340.  
  341. Close All
  342. Save All
  343. Closes (or saves) all the displayed windows. Saving does not close any
  344. windows. Any untitled windows will be ヤsaved asユ. You may notice ヤweirdユ
  345. command key equivalents for Close All (cmd-キ) and Save All (cmd-ァ). It
  346. turns out that キ is the same as ヤoption-Wユ while ァ is the same as
  347. ヤoption-Sユ. Thus, Close All is ヤcmd-option-Wユ while Save All is
  348. ヤcmd-option-Sユ.
  349.  
  350. <window name list>
  351. Each of the window names appears here for rapid selection. The first 9
  352. windows have command key equivalents ヤcommand-1ユ through ヤcommand-9ユ. Edit
  353. II can now handle unlimited windows (subject to available system memory set
  354. aside for it of course).
  355.  
  356. 3.    Keyboard Frolics
  357.  
  358. Cursor keys on the Macintosh Plus and above now work. Pressing the shift
  359. key extends the selection. In addition, if you have an extended keyboard,
  360. then the extra keys between the main keys and keypad also work as follows:
  361.  
  362. page up
  363. option-up arrow
  364. Moves to the previous screenful of text without changing the insertion
  365. point.
  366.  
  367. page down
  368. option-down arrow
  369. Moves to the next screenful of text without changing the insertion point.
  370.  
  371. option-right arrow
  372. Moves the insertion point to the end of the word (or next one).
  373.  
  374. option-left arrow
  375. Moves the insertion point to the start of the word (or previous one).
  376.  
  377. home
  378. command-up arrow
  379. Moves the insertion point to the beginning of the file.
  380.  
  381. end
  382. command-down arrow
  383. Moves the insertion point to the end of the file.
  384.  
  385.  
  386. command-right arrow
  387. Moves the insertion point to the end of the line.
  388.  
  389. command-left arrow
  390. Moves the insertion point to the start of the line.
  391.  
  392. del (delete to right)
  393. Deletes the character to the right of the insertion point.
  394.  
  395. enter (on keypad)
  396. Scrolls to the insertion point.
  397.  
  398. - (on keypad)
  399. Jumps around the five insertion points last clicked at. Note that
  400. double-clicking to select a word counts as two insertion points (a quirk of
  401. Cappsユ) and that Edit II will cycle through all five points, even though
  402. they are the same (like at the beginning). So if the insertion point seems
  403. stuck, keep on pressing ヤ-ユ!  Note that this can be turned off in the
  404. Preferences dialog.
  405.  
  406. F1ミF4
  407. Undo, Cut, Copy and Paste.
  408.  
  409. option-return
  410. If autoindent mode is on, then hitting option-return will move the
  411. insertion point to the start of the next line and not to do any
  412. autoindenting for that line.
  413.  
  414. You can also toggle the special cursor pad mode by hitting the num lock key
  415. on the numeric keypad. The num lock light on the keyboard will go off
  416. (indicating that the numeric keypad is now in cursor mode). This displays
  417. an additional (disabled) menu called CursorPad. The keys on the numeric
  418. keypad now take on special functionality as given below (like the I*M
  419. keypad):
  420.  
  421.  
  422.  
  423. 4.    GREP searching and replacement
  424.  
  425. GREP searching can be now done using regular expressions like the Unix GREP
  426. tool. Pattern matching of regular expressions is carried out as follows:
  427.  
  428. Patterns (regular expressions)
  429.  
  430. 1.    Any non-special character is a regular expression which matches itself.
  431. Characters [ ] ¥ and . are special characters and should be preceded by ¥
  432. (see rule 4).
  433.  
  434. 2.    A regular expression can be concatenated with another regular
  435. expression.
  436.  
  437. 3.    The . (period) is a special character which matches any one character.
  438.  
  439. 4.    The ¥ followed by any character except ( ) < > or one of the digits 1-9
  440. is a regular expression which matches that character.
  441.  
  442. 5.    A string of characters s surrounded by brackets [ ] forms a regular
  443. expression that exactly matches any one of the characters in s. The   
  444. regular expression [^ァ] matches any character not in the string ァ. If a
  445. sequence of 3 characters a-b occurs in the string, then this represents all
  446. the characters from a to b inclusive.
  447.  
  448. 6.    A regular expression R followed by * forms a regular expression which
  449. matches zero or more occurrences of R.
  450.  
  451. 7.    A regular expression surrounded by ¥( and ¥) matches whatever the
  452. regular  expression matches.
  453.  
  454. 8.    A ¥ followed by a digit n 1 to 9 is a regular expression which matches
  455. whatever the nth subexpression surrounded by ¥( ¥) matches.
  456.  
  457. 9.    A regular expression surrounded by ¥< and ¥> constrains the match to
  458. occur when the regular expression is immediately preceded and followed by
  459. characters which do not match [A-Za-z0-9_] and the first and last
  460. characters match [A-Za-z0-9_]. This allows us to look for "words".
  461.  
  462. 10.    A regular expression which starts with ^ anchors the search pattern to
  463. the start of a line. The ^ appearing anywhere else in the regular
  464. expression will match the character ^.
  465.  
  466. 11.    A regular expression ending in $ will anchor the search pattern to the
  467. end of a line. The $ appearing anywhere else in the regular expression will
  468. match the $.
  469.  
  470. Replacements
  471.  
  472. 1.    Each occurrence of & in the replacement string will be substituted with
  473. whatever was last matched by the regular expression.
  474.  
  475. 2.    Each occurrence of the form ¥n where n is a digit 1 to 9 will substitute
  476. whatever was matched by the nth subexpression enclosed in ¥( and ¥).
  477.  
  478. 3.    Each occurrence of the form ¥p where p is not a digit 1 to 9 will
  479. substitute that character p.
  480.  
  481. 5.    Workarounds and other hints
  482.  
  483. Edit II can only search for a pattern in a forward direction. If you want
  484. to search backwards, the best workaround is to go back to the start of the
  485. file (home) and then search.
  486.  
  487. All files are edited in memory. So if you have a large file, reset the size
  488. of the application using Get Info on the Edit II application icon and
  489. change the size of the application memory. Or better still - run under the
  490. Finder (and not MultiFinder). Naturally you shouldnユt edit a 2MB file on a
  491. 1MB Mac using Edit II!  Try as far as possible to have approximately twice
  492. the memory assigned to Edit II than the total size of all the files you're
  493. editing.
  494.  
  495. Holding the option key when Edit II is starting up will bring up the
  496. standard file open dialog box for you to select the name of a file to edit.
  497.  
  498. Edit II will try to save files when memory runs too low but there is no
  499. guarantee that it wonユt crash while doing this. The advice is to frequently
  500. check the available space (see the About Edit II... box to show the current
  501. amount of free memory).
  502.  
  503. Additional creator names can be inserted into the Creator menu by using
  504. ResEdit (use at your own risk!!). Note that exactly FOUR letters must be
  505. keyed in for each creator name.
  506.  
  507. Holding the control key when quitting from Edit II will forcibly turn off
  508. the num lock LED (just in case you ever need it!).
  509.  
  510. Edit II now supports file access permissions. This means that it should be
  511. possible to use Edit II on shared files in a network (I don't think Edit II
  512. itself is shareable on a network but...). The  read-only icon is shown on
  513. the bottom left hand side of the window when a read-only file is opened. It
  514. will remain in this state until saved (Edit II automatically prompts for a
  515. new name and will report an access conflict if you try to save the
  516. read-only file back to itself!), whereupon it changes to the read-write
  517. icon. The read-write icon is displayed when a read-write file is opened.
  518. This icon changes to the unsaved-file icon when any changes are made to the
  519. file (as a reminder to save it) and will revert back to the read-write icon
  520. when the file is saved.
  521.  
  522.  
  523. 6.    Bug Reports
  524.  
  525. If you find any bugs with this program, please write to me at the above
  526. address. You can also send electronic mail to me on America OnLine as KSeah
  527. or via Internet as kseah@aol.com or kseah@procyon.austin.tx.us.
  528.  
  529. 7.    Warranty
  530.  
  531. Kenneth Seah hereby disclaims all warranties relating to this software,
  532. whether express or implied, including without limitation any implied
  533. warranties of merchantability or fitness for a particular purpose. Kenneth
  534. Seah will not be liable for any special, incidental, consequential,
  535. indirect or similar damages due to loss of data or any other reason, even
  536. if Kenneth Seah or an agent of his has been advised of the possibility of
  537. such damages. In no event shall Kenneth Seah's liability for any damages
  538. ever exceed the price paid for the license to use software, regardless of
  539. the form of the claim. The person using the software bears all risk as to
  540. the quality and performance of the software.
  541.  
  542. 8.    Questionnaire
  543.  
  544. Copy, print this and fill in the blanks!
  545.  
  546. REGISTERING FOR: Edit II Version 2.2.1 March 11, 1995
  547.  
  548. NAME:
  549.  
  550.  
  551.  
  552.  
  553.  
  554. ADDRESS:
  555.  
  556.  
  557.  
  558.  
  559.  
  560. CITY:
  561.  
  562.  
  563. STATE:
  564.  
  565.  
  566. ZIP:
  567.  
  568. ELECTRONIC MAIL ADDRESSES (GEnie, InterNet, Compu$erve, AppleLink, America
  569. OnLine): [For updates and bug reports]
  570.  
  571.  
  572.  
  573.  
  574. Macintosh you have:
  575.  
  576.  
  577.  
  578.  
  579. Current version of your System Software:
  580.  
  581.  
  582.  
  583.  
  584.  
  585. Comments about Edit II (add more space if desired!):
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593. >>> Don't forget the US$15 shareware fee (add another US$3 if you want the
  594. latest on a disk)<<<
  595.